home *** CD-ROM | disk | FTP | other *** search
/ Aminet 32 / Aminet 32 (1999)(Schatztruhe)[!][Aug 1999].iso / Aminet / util / libs / graphics3d.readme < prev    next >
Encoding:
Text File  |  1999-05-23  |  11.0 KB  |  225 lines
  1. Short:    3D graphics shared library V15.10
  2. Author:   p.biancalani@mbox.match.it
  3. Uploader: p.biancalani@mbox.match.it
  4. Type:     util/libs
  5.  
  6. Version        15.10
  7.  
  8. --- English ----
  9. First sorry for my bad English but I don't know it very well.
  10. This is a simple but complete graphic 3D library that use for visualization
  11. only the system library .
  12. Main feature include :
  13.  
  14.    - Visualization of object in systems windows with single buffering.
  15.    - Support of polygons with one, two, tree and four vertex.
  16.    - Use of only fix point value than the math coprocessor is not
  17.      necessary, and is relatively fast on machines us A1200 base too.
  18.    - Implementation of visualization in Wire Frame ,Solid shading ,
  19.      Flat shading and now Goraud shading all simultaneous too and with light 
  20.      source freely placeable .
  21.    - Support of Z-Buffering.
  22.    - Support of Texture mapping with combination of other metod (except of
  23.      wireframe)and support of trasparent color.
  24.    - Add support of virtual color so the color of object is can be indipendent
  25.      from the number of color of the screen, see doc and example for more
  26.      informations.
  27.    - Direct loading of object with a custom format (is present an object converter
  28.      from .plg and .tddd object to this format)
  29.  
  30. New in this version:
  31. Any bugs fixed in clipping and rotate function and any minor change on tree 
  32. function, see history file.
  33.  
  34. Is tested on (for now): 
  35.    A4000/40 with S.O. 3.0
  36.  
  37. Sorry but I have suppressed the 68000 version for problem in linking.
  38. But if any necessed of this its will can be reintegrated. 
  39.  
  40. THIS LIBRARY IS A COPYRIGHT OF THE AUTHOR PATRIZIO BIANCALANI AND IS A 
  41. FREEWARE SOFTWARE THAN FREELY USABLE AND DISTRIBUITE BUT WITH ALL FILE OF 
  42. ORIGINAL ARCHIVE AND NOT FOR RESALE OR IT CAN'T BE SOLD, THAN I PROVIDE 
  43. ABSOLUTELY NO WARRANTY FOR THIS SOFTWARE.
  44. IF YOU WANT MODIFY THE ORIGINAL SOURCES TELL ME THIS THAN ,IF IT IS OK, 
  45. I CAN UPDATE ALL ORIGINAL ARCHIVE.
  46. It is very pleasant if you send me an e-mail if you use it.
  47.  
  48. I have included an example write in E (and full commented) and all the source
  49. in C of this library .The executable is 3dlib and it must be in the same
  50. directory of #?.plg files.It can use more colours with the parameter "256" in the
  51. command string (for machine with almost AGA and S.O. 3.0).
  52.  
  53. The file graphics3d_020_CPU.library is the library for CPU from 68020 with new metod of rendering.
  54. The file graphics3d_020_BLT.library is the library for CPU from 68020 with old metod of rendering.
  55. You must rename the correct library to graphics3d.library before use it.
  56.  
  57. Thanks to:
  58.    Maciej R.Gorny for the original routin of engine 3D.
  59.    Alessandro Franchi for beta testing on A1200.
  60.    VolKer Barthelmann author of VBCC the C compiler used by me to write the
  61.    library.
  62.    Andreas Kleinert author of the optimal startupcode for write shared
  63.    library. 
  64.    Nautilus that have explain to me the algoritm to do goraud shading , z-buffer
  65.    and texture mapping.
  66.    The authors of Tornado3D for the suggetions to implemented the single
  67.    buffering in a window. 
  68.    All ones that have write an e-mail to me.
  69.  
  70. I'am Patrizio Biancalani from Prato (Italy) and the my E-Mail for
  71. suggestions and signaling is :p.biancalani@mbox.match.it
  72.  
  73. Support site :www.amigaworld.com/support/graphics3dlib/welcome.html
  74.  
  75. --- Italiano ---
  76.  
  77. Questa e' una semplice ma completa libreria grafica 3D che si appoggia
  78. interamente sulle librerie di sistema per la visualizzazione.
  79. Le caratteristiche principali sono:
  80.    
  81.    - Visualizzazione oggetti nelle finestre con single buffering.
  82.    - Supporto di poligoni a uno, due, tre e quattro vertici. 
  83.    - Usa valori solo in fix point quindi il coprocessore non serve
  84.      ed e' relativamente veloce anche su macchine come il A1200 base.
  85.    - Implementa la visualizzazione in Wire Frame ,Solid shading, 
  86.      Flat shading ed ora Goraud shading anche tutti contemporaneamente e con 
  87.      la fonte di luce posizionabile a piacere.
  88.    - Supporto dello Z-Buffering.
  89.    - Supporto del Texture mapping in combinazione con gli altri metodi (ad
  90.      eccezione del wireframe) e supporto del colore trasparente.
  91.    - Aggiunto il supporto dei colori virtuali cosi' che il colore degli oggetti
  92.      oggetti sia indipendente dal numero di colori dello schermo.
  93.      Per maggiori informazioni vedi l'esempio e la documentazione.
  94.    - Supporta il caricamento di oggetti in formato propietario.(E' presente un 
  95.      convertitore da oggetti .plg e .tddd verso tale formato).
  96.  
  97. Novita' in questa versione:
  98. Eliminati alcuni bug nelle funzioni di clipping e rotazione , effettuate anche
  99. alcune variazioni su tre funzioni , vedere l'history file.
  100.  
  101. E' stata testata su(per ora):
  102.    A4000/40 con S.O. 3.0
  103.  
  104. Spiacente ma il supporto del 68000 e' stato soppresso per problemi nel linkaggio.
  105. Ma se fosse necessario a qualcuno posso sempre cercare di reintegrarlo.
  106.  
  107. QUESTA LIBRERIA E' UN COPYRIGHT DELL'AUTORE PATRIZIO BIANCALANI ED E' UN
  108. FREEWARE SOFTWARE QUINDI LIBERAMENTE DISTRIBUIBILE MA CON TUTTI I FILE
  109. DELL'ARCHIVIO ORIGINALE E NON PER FINI DI LUCRO, IO NON FORNISCO 
  110. ASSOLUTAMENTE ALCUNA GARANZIA SU QUESTO SOFTWARE.
  111. SE VOLETE MODIFICARE I SORGENTI ORIGINALI COMUNICATEMELO, SE E' ACCETTABILE
  112. IO AGGIORNERO' L'ARCHIVIO ORIGINALE.
  113. E' molto gradita la ricezione di un e-mail in caso di uso della libreria. 
  114.  
  115. Ho incluso anche un esempio di uso scritto in E e i sorgenti in C della
  116. libreria.L'eseguibile si chiama 3dlib e deve essere nella stessa directory
  117. dei file #?.plg .Se si da il parametro "256" nella stringa di comando si potranno
  118. usare piu' colori (solo per macchine con almeno l'AGA e il S.O. 3.0). 
  119.  
  120. Il file graphics3d_020_CPU.library e' per le CPU dal 68020 con nuovo metodo di visualizzazione.
  121. Il file graphics3d_020_BLT.library e' per le CPU dal 68020 con vecchio metodo di visualizzazione.
  122. Occorre rinominare la corretta libreria in graphics3d.library prima di
  123. usarla.
  124.  
  125. Si ringrazia :
  126.    Maciej R.Gorny per le routin del motore 3D.
  127.    Alessandro Franchi per il parziale beta testing su A1200.
  128.    VolKer Barthelmann autore del compilatore C VBCC da me usato per
  129.    la stesura della libreria.
  130.    Andreas Kleinert autore dell'ottimo startupcode per le shared
  131.    library. 
  132.    Nautilus che mi ha spiegato l'algoritmo per il goraud shading , lo z-buffer
  133.    e il texture mapping.
  134.    Gli autori di Tornado3D per il suggerimento su come implementare 
  135.    il single buffering in una finestra.
  136.    Tutti quelli che mi hanno scritto.
  137.  
  138. Io sono Patrizio Biancalani residente a Prato Italy e il mio E-Mail per
  139. suggerimenti e segnalazioni e': p.biancalani@mbox.match.it
  140.  
  141. Sito di supporto :www.amigaworld.com/support/graphics3dlib/welcome.html
  142.  
  143.  
  144. ============================= Archive contents =============================
  145.  
  146. Original  Packed Ratio    Date     Time    Name
  147. -------- ------- ----- --------- --------  -------------
  148.    15228    6450 57.6% 23-Jan-99 09:46:40  3dlib
  149.      625     148 76.3% 20-Dec-98 11:32:36  assi.3dgfo
  150.      465     155 66.6% 21-Jan-99 18:46:12  assi.plg
  151.   132732   24990 81.1% 21-Dec-98 13:03:22  chair.tddd
  152.    14816    5943 59.8% 23-Jan-99 09:46:56  conv
  153.      342     101 70.4% 06-Jan-99 11:29:58  cube.3dgfo
  154.      602     237 60.6% 21-Jan-99 18:46:10  cube.plg
  155.     1797     666 62.9% 22-Jan-99 18:54:54 +graphics3D.fd
  156.     3550    1502 57.6% 23-Jan-99 09:30:42 +graphics3D.i
  157.     1797     666 62.9% 22-Jan-99 18:54:54 +graphics3D.fd
  158.     4027    1547 61.5% 23-Jan-99 09:30:14 +graphics3D_pubblic.h
  159.     2516     945 62.4% 22-Jan-99 19:21:28 +graphics3D_stub.lib
  160.      812     368 54.6% 22-Jan-99 18:54:54 +graphics3Dbase.h
  161.      739     345 53.3% 23-Jan-99 09:41:02 +graphics3D.m
  162.      840     418 50.2% 23-Jan-99 09:41:04 +graphics3D_lib.m
  163.    21851    5918 72.9% 21-Jan-99 23:47:52 +graphics3D.h
  164.    11399    3649 67.9% 21-Dec-98 12:34:50 +graphics3D.h.doc
  165.     4474    1982 55.6% 11-May-99 23:46:00 +graphics3d.history
  166.     1394    1083 22.3% 26-Feb-98 23:35:00 +graphics3d.history.info
  167.     4726    1949 58.7% 16-Feb-99 00:12:22 +graphics3d.notes
  168.     1394    1084 22.2% 27-Feb-98 23:39:42 +graphics3d.notes.info
  169.    56996   14312 74.8% 11-May-99 23:42:54 +graphics3d_E.doc
  170.     1154     757 34.4% 27-Feb-98 23:35:52 +graphics3d_E.doc.info
  171.    76930   15821 79.4% 16-May-99 12:40:26 +graphics3d_E.guide
  172.     1611     755 53.1% 26-Feb-98 23:31:42 +graphics3d_E.guide.info
  173.    59811   15188 74.6% 09-May-99 13:24:50 +graphics3d_I.doc
  174.     1154     757 34.4% 27-Feb-98 23:35:44 +graphics3d_I.doc.info
  175.    79827   16800 78.9% 16-May-99 12:39:42 +graphics3d_I.guide
  176.     1611     755 53.1% 26-Feb-98 23:31:42 +graphics3d_I.guide.info
  177.     6645    2999 54.8% 11-May-99 23:47:04  graphics3d.readme
  178.    32756   17630 46.1% 15-May-99 13:15:20  graphics3d_020_BLT.library
  179.    37984   20058 47.1% 15-May-99 12:56:20  graphics3d_020_CPU.library
  180.     5912    1497 74.6% 10-Jan-99 23:52:22  prova.iff
  181.      236      87 63.1% 06-Jan-99 11:30:12  pyramid.3dgfo
  182.      944     418 55.7% 21-Dec-98 09:48:24  pyramid.plg
  183.    34829    8483 75.6% 17-Jan-99 12:38:08  sfera.3dgfo
  184.    30984    8132 73.7% 21-Dec-98 09:48:22  sfera.plg
  185.    22149    6285 71.6% 22-Jan-99 18:55:20 +conv.e
  186.    12035    4044 66.3% 23-Jan-99 09:46:00 +3dlib.h
  187.    12092    4122 65.9% 22-Jan-99 18:54:42 +3dlibdemo.e
  188.     1125     603 46.4% 22-Jan-99 18:54:42 +3dlibh.h
  189.      129     102 20.9% 17-Oct-98 12:41:12 +compila
  190.    16336    4355 73.3% 28-Jan-98 21:27:22 +gad.h
  191.     2389     863 63.8% 13-Apr-97 09:58:52 +gen.h
  192.      739     345 53.3% 23-Jan-99 09:41:02 +graphics3D.m
  193.      840     418 50.2% 23-Jan-99 09:41:04 +graphics3D_lib.m
  194.      598     323 45.9% 22-Jan-99 18:55:10 +debuglib.c
  195.      269     152 43.4% 22-Jan-99 18:55:10 +debuglib.h
  196.     1797     666 62.9% 16-Feb-99 00:12:16 +graphics3D.fd
  197.    15358    4797 68.7% 16-Feb-99 00:12:12 +graphics3D.h
  198.     3728    1586 57.4% 16-Feb-99 00:12:12 +graphics3D.i
  199.     6023    1705 71.6% 11-May-99 23:57:30 +graphics3D.make
  200.    16323    4690 71.2% 16-Feb-99 00:12:14 +graphics3D2d.c
  201.     1017     350 65.5% 16-Feb-99 00:12:16 +graphics3D2d.h
  202.    26266    6971 73.4% 16-Feb-99 00:12:16 +graphics3d2d_o.c
  203.      443     225 49.2% 16-Feb-99 00:12:16 +graphics3d2d_o.h
  204.      976     362 62.9% 16-Jan-99 16:14:04 +graphics3D2d_proto.h
  205.      812     368 54.6% 16-Feb-99 00:12:16 +graphics3Dbase.h
  206.      791     367 53.6% 16-Feb-99 00:12:16 +graphics3Dc.h
  207.    38018   10190 73.1% 16-Feb-99 00:12:14 +graphics3Df.c
  208.     4819     960 80.0% 16-Feb-99 00:12:14 +graphics3Df.h
  209.    29735    8559 71.2% 16-Feb-99 00:12:18 +graphics3df1.c
  210.    13679    4340 68.2% 16-Feb-99 00:12:18 +graphics3df_g.c
  211.    18465    4840 73.7% 28-Feb-99 11:29:34 +graphics3Df_i.c
  212.     9326    2309 75.2% 16-Feb-99 00:12:18 +graphics3Df_i2.c
  213.     4442     946 78.7% 16-Feb-99 00:12:16 +graphics3Df_proto.h
  214.    12075    2659 77.9% 16-Feb-99 00:12:18 +graphics3Df_t.c
  215.     5079    1861 63.3% 16-Feb-99 00:12:18 +graphics3dl.c
  216.      298     210 29.5% 16-Feb-99 00:12:18 +graphics3dl.h
  217.      291     205 29.5% 16-Feb-99 00:12:18 +graphics3dl_proto.h
  218.     6553    2088 68.1% 11-May-99 23:46:36 +graphics3Dli.c
  219.      926     326 64.7% 01-Jan-99 12:16:02 +graphics3dm.c
  220.     2601     594 77.1% 16-Feb-99 00:12:18 +graphics3dm.s
  221.      607     352 42.0% 16-Feb-99 00:12:18 +graphics3Dm68k.c
  222.     8523    2218 73.9% 16-Feb-99 00:12:14 +graphics3Dsu.c
  223. -------- ------- ----- --------- --------
  224.   953182  270951 71.5% 16-May-99 21:16:40   75 files
  225.